Inside Macintosh: /

QuickDraw 3D RAVE / QuickDraw 3D RAVE Reference

QuickDraw 3D RAVE Routines / Public Draw Context Methods

TQADrawVGouraud

A drawing engine may define a method to draw Gouraud-shaded objects defined by vertices. This method is optional and must be supported only by drawing engines that do not want calls to QADrawVGouraud to be replaced by calls to the QADrawPoint, QADrawLine, or QADrawTriGouraud methods.

typedef void (*TQADrawVGouraud) (
                                 const TQADrawContext *drawContext, 
                                 unsigned long nVertices, 
                                 TQAVertexMode vertexMode, 
                                 const TQAVGouraud vertices[], 
                                 const unsigned long flags[]);

drawContext

A draw context.

nVertices

The number of vertices contained in the vertices array.

vertexMode

A vertex mode. See "Vertex Modes" (page 1-56) for a description of the available vertex modes.

vertices

An array of Gouraud vertices.

flags

An array of triangle flags, or the value NULL. See "Triangle Flags Masks" (page 1-63) for a description of the available triangle flags. This parameter is valid only if the vertexMode parameter contains the value kQAVertexMode_Tri, kQAVertexMode_Strip, or kQAVertexMode_Fan.

DESCRIPTION

Your TQADrawVGouraud function should draw the vertices in the array specified by the vertices parameter into the draw context specified by the drawContext parameter, according to the vertex modes flag specified by the vertexMode parameter. For instance, if the value of the vertexMode parameter is kQAVertexMode_Polyline, then the vertices in that array are interpreted as defining a polyline (a set of connected line segments). Gouraud shading should be applied to whatever objects are drawn.